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1.9 INTRODUCTION 


1.9 INTRODUCTION 


This document descrives the precess for Integration and 
development of the NOS/VE product sete. It is directed mainly toward 
the role of development in thelr Interaction with Integration. 


An overview of our catalog structure is discussed firste This 
includes the residence of all the NOS/VE oroduct!s source and the 
structure of a completed, Installed product sate 


The source for aach product must be In NOS/VE Source Code litility 
format. The conventions for these SCU Vibraries are giver tn 
sectlon 3, 


Section 4 will prove useful as a guide for ali of our available 
speclajl procedures and tools. 


If a$developer Is transmitting a new oroduct te Integrations he 
or sha must provide a short verification job and a quicklook test 
which are run after the completion of each build cycle. The 
instructions for thls process are given in saction 5. 


Sections 6 and 7 dascribe our develooment orocedures, These 
procedures were written in Arden Hills for thelr operating system 
developmant and we have adopted them In Sunnyvale for the oraducts.s 
Appendix A gives a sumaary of aach command and its parameterses 
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201 SQURCE MAINTENANCE SISUCTURE 


The SCU ftibrary for each product Is kept In the INTVE catalog. 
Nnee integration raceiveas a new product, the source tibrary is 
placed Into this catalog. From this moment ons this will be the 
onivy copy of the source and the developers use this as thelr base 
for axtracting and replacing changed decks. 


When a daveloper extracts dacks from their INTVE sources this 
subset of dacks will be In SCU format and reside on thelr “working 
catalog". This Is usually a parson's main cataloge 


Tf a number of individual developers are working on the sama 
feature or projact for a product», they can set up a "feature 
Catalog". The featura catalogs ieee another main catalog or a 
sub-catalogs would contain all the decks pertaining to the project. 
Fach develoner would extract decks from the source In the feature 
estalog into their individual working catalogse See diaaramr 1. 
Section 6 discusses the procedures which work with this catalog 
structures 


Decks ara iIntarlockad when they are extractad to prevent updates 
gettina fost by heing overwritten by an alder version of the deck. 
Intertocks are discussed sore In section 3. 
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Z2el SOURCE MAINTENANCE 


STRUCTURE 


STRUCTURE 


os 62 6s of 


DIAGRAM 1 


eINTVEs ST LOS .-SOURCE_ LIBRARY 


fp eine 0 we ar nee a ene a em a soe en nm a dp 
: Contains entire 2 
> source for product. 
H Decks A thru Z : 


$ 

$ 

: Extract decks A thru 

3 

2 eae anne $ 

v z 
ePFEATURE CATALOG .SQURCE_LIBRARY 2 
pe eee ne ne oe a ee ee ee a a a ef 3 
+ Subset of iIntve source ; : 
2 library containing 3 Optional 
8 decks A thru Me : : 
$n + : 
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3 3 

3 3 

: Sateteatentetoed ¢ 

3 

3 3 
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3 t 
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V 


eVISERL -SQURCE_LIBRARY 
bp ass a te mc SD AR AND A URL AED AE Re we ee eta wane wR END ont dhe 
: Subset of feature 3 
2 source Jibrary 3 
: with decks : 
3 & thru 2 3 


Notess PT 


eUSER2.SOURCE_LIBRARY 


3 Source ilbrary 2 
: containing ontivy 3: 
3 deck F : 


fe e-em cae ee eee me ew ne en ee ee OO OD een ne de eee ee ee dp 


Is the twokletter product Identifier 


eUSERS SSQURCE_LIBRARY 


2 Source Iibrary 3 
3 containing 3 
$ decks L and 3 


. ge 
Integration and Development Guidelines and Conventions 
200 CATALOG STRUCTURE 
2Zelei THE INTVE CATALOGS 


2elel THE INTVE CATALG 


Each product will nave ai subcatalog In the main integration 
catalone Each product subcatalog will contain all thea data 
necessary to maintain that products specifically the SCU source 
library and bulld orocadures. 


Al? the source tibrarties in the INTVE catalog are kept in a 
subcatalog identified by the product's 2-letter Identifier followed 
by the ralease seauancea number, 


For examples, tha FORTRAN product's source Files corresponded with 
the following releases: 


EALEW EELEASE. BATE 
eintve.fc_Slesource_Ilbrary R192 Aprils, 1984 
eintve.~fce_02.source_llbrary Rl.14i Augusts 1984 
eintve.~fc_03.source_library 81.1.2 est. Marchs 1985 
elntva.feo_%4%.sourca_library 81.1.3 este Junes 1985 
eintve.fe_G5esource_tibrary R1.261 est, Decembers 1985 


Of ceurses not all the files are on aur disk packs at ona time In 
order to conserva disk spaces Normallys one would find two source 
Yibraries for each product on the INTYE catalogs The previous 
libraries are stored anto magnetic tares. 


The following is a table showing each proeduct with Its 
corresponding two latter identifier: 
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IDENTIFIES PROOUCT 


AA AAM — Advanced Access Method 
AP APL —- A Programming Language 
C8 COBOL complier 

cc CCH =~ Common Compiter Modules 
CG ccs - Common Code Generator 

DB DEBUG utility 

FA FMA =~ File Migration Ald 

FC FORTRAN compiler 

FL FRTL ~ Fortran Runtime Library 
FM FMJ — File Management Utility 
Huy | HELP =~ Help Utility for On-line Manuals 
LI LISP =~ Lisp Interpreter 

ML CMMNL — Mathematics Library 

OM MANUALS ~- On Line Manuals 

PA PASCAL comoller 

PE PROGRAMMING ENVIRONMERTS 

PR PROLOG interoreter 

SM SORT/MNERGE utility 

ST - aDIT CATALOG utility 

TT TEST TIOL LIBRARY = Testing Environment Utility 
78 . ZEUS ~ A Report Generator 


Each source Jibrary in the INTVE catalog must have a “latest 
changes" and a “logging” File associated with it. Fer examples for 
fortran'ts third raleasey, the INTVE catalog would contain 
eo INTVE -FC_03 eSTURCE_LIBRARY, e INTVE.FC_O3.LATEST_CHANGES and 
»oINTVESFC_O3.LOGGING. 


Tha tatest changes flla is an SCU source !ibrary containing one 
day's worth of updated dacks located In the source library. When a 
developer wants to update code on the source fYibrary In INTVE via 
the transmit ito _integration procedures the changes are located onty 
on the latest changes filie until the following day. Each mornings 
all of our NOS/VE product's latest changes files are combined Into 
the main source library. 


The toaging file contains Information about each extract of code 
or transmission of code between source {lbrarltes. 
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2e2 CATALOG STRUCTURE _OF_a_ COMPLETED PRODUCT SET 


A comoletad product sat bullt by Integration Is usually installed 
into the SSYSTEM cataloge. If there are concurrent bullds related to 
different releases, tha closest reftease is Installed in *SYSTEM and 
the future release Is installed Into the INT18G catalog. The 
$SYSTEM products ara automatically available to anyone using 
NOS/VE. To use products from the INT18C catalog» see the SETPC 
command in the Sunnyvale Toots Librarys, described in DCS document 
$4792 


The $SYSTEM and INT180 catalog structure consists of full product 
nama subecatalogs contalning run time tibraries and bound seroducts. 
A further breakdown in structure is the maintenance catalog which 
contains files such as unbound fibraries and maps. 


For examples a FORTRAN product Installed into the S$SYSTEM catalog 
would consist of thasa Files: — 


EILEW DESCRIPTION 

Ssystem.fortrane-bound_product | Fortran compiler with aj 
references to other oroductis 
satisfied 

$system.efortran.fifsitibrary Fortran library used during 


rum time or execution 


system. fortran. Fortran library created solely 
maintenance. unbound component from cybii and assemble 
binartes 


tsystem.fortran. Round fortran module 
maintenance. dound_ component 


asystem,.fortranemaintanansceemap Loadman created during the 
hinding process 


Ssystem.fortrane Command ilbrary conteining 
maintananceeconmand library fortran's program descriptions 
and error templates 


Not 211% products nave all thease related files. Some common 
eroducts are not bound. 


The catalog structure Is the same In the INTI&S catalog. The 
only difference is thea main catalog name, 
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3.0 SCU_LIBSASY ORGANIZATION 


3e1 DECK ORGANIZATION 


Aeolei USAGE OF GROUPS 


Critical to the structure of the product's source tibrariess and 
to the efficiency of the source maintenance procedures» is the 
association of SCU “group names" with each deck on the IJibrery. 
These groups may be used to manipulate "blocks" or “groups” of 
deckss such as all decks In a Job template or system core JVlbrarys 
fairly easily. 


The different types of groups are identified by the conventions 
used to name them. Except far the "erocessor™ and "ganeric™ groups 
(described balow)» the format of all group names is? 


x¥xy%3aaaanaa 


where 'xx' is the product identiflers “aaaaaa” is a descriptive name 
for the particular groups and “y"™ is one of the following: 


$ Specifies a “Source™ groups 1.e. a subdivision of the 
source library Into component Jitrartes.s Saveral 
examples of groups of this type are? 


oss$progran_Interface (osfSeroaram_inter face) 
fes$front_and 
cbstcobol source 


F Specifies a “destination Flle™ group (1.2. 23a file onto 
which a dack is to be nlaced after processing). Several 
examplfes of groups of this type are: 


aaf%44) _ library 
osf$monitor 
osftobjact _coda_utilities 
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G Seecifiles a "Group™", eee a collection of decks that 
have bean decidad would be useful to be able to refer to 
@nN MassSee Several examples of arounps of this type ares 


chgSprocedure_common_dacks 
chgsrun_time_ procedures 
fegSbridge modules 


NOTE? All decks on the source library which belong in the tibrary 
psfhexternal_interface_source should be associated with the group 
name "psfthexternal_inter face _saurce™, Keaypoint decks and error 
codes should also balong to this group, 


Most other group names will follow the conventions described In 
the orevious text for the product source libraries. Heowevers, there 
are two classes of groups for which this Is tInaporooriate; 
“proacessor™ groups and “yganeric™ groups. 


A “processor™ group will be alven the same name as the 
corresponding processors 8ede the group name for decks te he 
compiled by CYBIL will ba "CYRIL". Other processor group names ere? 


assemble 
fortran 
cobel 

eo compass 
cp_compess 
cybiicce 


Note that some of these must obviously be processed on the NOS 
side of the machina. 


A "ganeric™ group is used in thos2® cases where knowing the 
processor for a deck Is Lnsuffictent for some puroonse, The generic 
groups that have heen identified and are reaquireds If apnlicahtas 
are: 


common 
program descr lotions 
message_templates 
scl_uprocedures 
ecl_uprocedures 
scu_salectionicritaria 
buidd procs 

deletad decks 


All decks which are called by other decks wil! belong to the 
group “common”, Whan a dack needs to be deleteds it should betong 
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to a group “deleted decks™. At this point In times the deck Is not 
really delateds so the builld procedure must be specifically 
excluding this deck until sarmeene In Integration can physically 
delete the deck. This will only be dona between releases to insure 
our ability to back up to 4 previous level. 


Some of these generic groups overlan to some extent with the 
processor groupse 


A deck may have up to 255 group names associated with It. At 
this point In times a graup cannot bea associated to another groupe 
A DAP has been written to allow this caoability. For the time 
beinas issue the change deck SCU command to establish all deck to 
grour associations. 


3e122 INTERLOCKS 


Among the information in an SCU deck header ere the original 
Interfock and sub-interlock fleids. When a deck Is extractad from a 
sourca Jibrarys, the sub-interlock field Is sat to contealIn the name 
of the user which asked for the deck and the date and time of the 
extraction. After this sub-interlock fleld is set» the deck cannot 
he extracted by anyone. 


When the sub-intarlock field is set on the Ifbrary where the deck 
resides» the deck now also resides on the source tlibrary in the 
user's cataloge The original! Interlock field Is set for this deck 
on the user's source Jibrary to the same values of the main 
Yibrary's sub-Interlock fields 1.@. the user name and date and time 
of extraction. 


After changes are made to this deck and it is transmitted hack to 
the matin tlilorarys the transmit command used checks that these 
sub-interlock and original interlocks match between the two source 
Yibraries. After the transmit is completes the tuo interlock flelds 
are cleared. 


Thea following diagrams explain the Interlock settings when a deck 
is extracted from the integration catalcoq. The first examole shows 
an extraction Into thea working cataleg only. The second examole 
shows the resujt of using a feature catalogs 
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/ 


~ an” ae a ee ee ee, ee) ee ee 


Pn ae ee ee en ee ee ee, ee 


Intertlocks: Usage of a working catalog onive i.@. no feature catalog. 


Z 
See ee en es ee ee a eh an no a te ame a wae te 
te INTVE.PT_On.Source Library 2 
8 Ae aan en eo can ee mH aw wna ae om an en om sm ee mY 
* Neck A : 
2 ee ee ae ae ? 
: Original a 
: Interlock: none 3 
w= Sub 3 
’ Intertack? USERLNAME H 
3 Data: XX Timesyy ? 
fe mee a ne ee Oe ae a ee a nn ea mee dp 
ZeINTVE.PI_OnslLatest Cnanges 2 
Bae ee es re See ND 2 SS BE A NO DD ALS Nore eN awe one wen & 
: Deck A 3 
2 we we ae ene coe ae : 
~~ Original USER NAME 3 
$ Interlock: Pate: XxX Timesyvy 3 
om Sub 3 
t Interlock: USER NAME 3 
; Date: XX Times7Z 3 
Je ee eh 0 20 0 SH OD AND A SO SD ee DD oD D. sn see ame fo 
eae a0 ee aah a A Oe a me fp 
teWorking Catalog.Saurce Library: 
: Neck A 3 
2 mn ee eee anew aoe ae 2 
-- Original USER_NAHE H 
$ Interfock: Dates XX Tlme:77Z 2 
& Sub 3 
s Interlock? none 3 


fp ee ee cre ee ee 0 ek ee A 0 HN FO Can MRD ER ER SO He ED OD Ge ee we eee eRe wee see oh 


Neck A has bean axtracted Into 
the working catalog and all 
Interlocks have bean sate. This 
deck can now be modifiad In the 
working catalog. Oack A cannot 
be extracted for the purposes 
af making changes at this time 
hy anyone else. 


/ 


3 
3 
2 
3 
3 
3 
\ 


2 
a ae ae ae ee em owe sem cow te ee a ove eo eae + 
TeINTVE oP T_OneSource Library 3 
2 ese oe a ae oe me mn ee eae ms enw me a mL Sew ae se se $ 
: Deck A 3 
3 eee nn eee ae eee 2 
3 Nriginal 3 
t Interlock: none 3 
=m=- Sub 2 
: Interlock: USERNAME 3 
3 DatezxX Timer YY 2 
ee eee oe nae ts Sa Se VOD SN I SO RNS OS RE A HS ED Se SY on aan a ce eo some be 
ar ee a wo we ne eo me en oe a cw ec we a enw nm com a fp 
teINTVEePI_Onel atest Changes 3 
: Neck A 2 
2 meee no eae ate ae mee ome z 
-- Original USER _ NAME 2 
$ Interlock: Date:xx Timez yy 3 
t Sub z 
: Interlock! none 3 
: 2 


2.Working _ CatelogeSource_Library 


9 
» 


3 
3 Deck A does not eaxist on 
3 this library after trans=- 
: mission back to Integra- 
3 tione 


+ RD CAND OE AD LOND VND VED Si AED ED ONS SED OD GD BUED HOD MOND SE OTD ED ED ND en Me a a ee 


The deck has been transmitted 
back to the Integration cataioa. 
Even though an interlock stiil 
axists batween the intve fatest 
changes and main source librarys 
this deck can be reeextracted by 
another or the samé us®re 


3 


3 
3 
$ 
3 
3 
+ 
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3 
pe wt me a ae a er ete a de ee a en a a ee a | 
teINTVE.-pi_On.Sourcea Library 3 This diagram shows the result of 
§ eee ee naar ne 0 mnie nal anaes sek em entinn ree on St amie eras ane Sef the latest chances fille having 
2 Jack A 2 been combined with the main 
a eran H source library. This automatli- 
: Original 3 cally occurs every morning and 
3 Interiock: none 2 Is the responsibility of the 
: Sub 3 Integration group. 
: Interlock: none 3 
a re wn ee ee ee rte see ae me cae an cere one et emcee ae mn ew 


seINTVE.»pi_On.Latest_Changes : 


. 3 
: : 
$ Empty source {fibrary : 
: 3 
2 3 
3 ? 
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Intertocks: Usage of a feature catalog. 


1 
+ 0 ne me se ae en ee ne in es em ee mA ni ee ee Extraction of Deck A through 
eINTVE.PI_On.Sourcea_Library 3 the feature catelog to the work= 
$ eee ee ee ae en ae ere ma a en ee en a me em Ing catalog sets deck Inter- 
: Neck A 3 locks. Changes to the deck are 
3 meee ow an oc ce a em H made at this time In the workina 
? Original 3 catalog. Deck A cannot be 
> Intertock: none z extracted now by anyone. 
Jwe Sub 3 
£ Interlock: USER_LNAHE 3 
: Dates XX Timer vy 2 
fee a a ae nn a nN a a HN Ws ee fp 


t 
3 
3 
$f wee eee emcee ae ee Se a ea em a ep 
3 t.INTVE.»PI_OneLatest Changes H 
ee eee eee 
: t Dack A 2 
oe t 
\-- Original USER NAME : 
: Interlock: DatazxXX TimetYy 3 
fom Sub 3 
2 Interlock: USER NAHE 3 

3 DatesxXx Tiaes?2Z 3 

+ 


+> PG AD GS GED TEE EE AD OD OD AY ND RATS Dee AG I OD ND cael) AED END ode OD AD OE ES AO ND AE Ae ee 


t 
3 
. 2,.Feature CatalogeSource Library? 
\ 


: Deck A ; 


2 een ee ee 2 
\=-- Original USER NAHE 2 
> Interlock: DatetxXX Time?77 3 
I-- Sub 2 
$ Interlock: USER_LNAHE : 
3 CatazXX Timez ww 3 
ee ee ne ea ence ere mae ee ne a a nam een mee 


$ 
: 
: 
: 
: t.Working_CatalogeSource_Library: 
: 
2 
\ 


2 NO AED OUD ITD VAAN AND: END CDE OD UE ES AD GAGE GED TENE UND ND Welle UMD SD COND Rnd NS Hee HEED Ge 4 CED ED wD 3 


: DNack A 3 


Sem eee nn ew eae wns wen nae 3 
-~- Original USER_NAME i 
2 Interlock: Dateat XX Times Ww 3 
: Sub 3 
’ Interlock: none 2 
2 2 
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2 
pen ee ee cas 0 eee me ED NL NO ES AO DO SD OD Nw TD TN none nee ame Mane ne seme fe 
te,INTVE.PI_On.Source Library 3 
3 an en oe ae ct nt ee ef 
> Nack A 3 
2 eee nee ae 2 
: Original 3 
: Interlock: none g 
f~= Sub ; : 
3% Interlock: USERNAME 3 
2 3 Date: XX Times77 3 
Bp nee ee ee een een ame ae ean ane ee mw ene mmr ee te 
2 
Bh eee ee ae mee er rece eee me ee nw we eon nt we et een oem wan ee dp 
t teINTVEsPILOneLatest_Changes ; 
SD eee ee ee ae ences ere mee a ee see eee ao naa eee a emcee 3 
2 3: Since the extractions the 3 
$ : SQURCELLIBRARY and tna 3 
2 3 LATESTLCHANGES filas have 3 
2 3 combined. Deck A is no 3 
$ 3: tonger an LATESTLUCHANGES. : 
? 2 3 
3 
Se ors 
2 
Bp ewe eae ce ae ca ne me ens ee ne magne eed seen mee 
2 3.Feature Catalog.eSource Library: 
BS ee ee a ae ee eer ce ee ae ew ee me ee ee ee eet 
2 3 Deck A 3 
re 
\-- Original USERNAME : 
2 Interlock: Dates: xXx Times77Z : 
3 Sub 3 
? Interlock: none 3 


?eWorking_Catalog.Source_ Library: 


3 2 
s Peck A doas not axist an i 
: this tibrary after trans : 
: mission to feature catalog. 3 
2 2 
2 3 


Deck A was transmitted back to 
the feature catalog. The deck 
can now be re-extracted Into 
another working catalog or given 
back to the INTVFE catalog. 


Note the change In the Interitock on 
SOURCE LIBRARY due to the combining 
with LATEST_CHANGES,. 
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3 


3 


eINTVE.PI_LOn.Source_ Library 


3 


2 
3 
3 


5 
* 


Neck A 
Driginal 


Interlock: none 


Jmw= Sub 


3 


a 26 we 46 06 06 06 


3 


* 
2 


Interlock: Featura catalog 


Date: XX Times7Z 


be ce oe te be te #0 


4 
* 


oINTVE.PI_On.Latest Changes 


$ 


2 
3 


> om 


oe 96 o6 06 


Deck A 

Ariginal Featura catalog 
Interlock: DateazXxXX Time:77 

Sub 


Interftock: none 


g 


oe a6 42 26 fe 8 


t:eFeature_CatalogeSource Library: 


+4 ED RED TR TS A eee eA HED len a WE ee Sted WED ORD HOD LEE OS Heed FER HERD WG HRD geBh ete ome Ree Gar 4D ee z 


3 


> se 26 e868 te be 06 


Deck A does not exist on 
this tibrary after the 
transmisslon to tha intea=- 
gration catalog. 


CED CD CD WT WD ERD EES SEO CEE ERE GD ESE Erle ee MEE ORD ED ee th LS A OS HD ROD WEE HER BL ED Ie UEP ee 


3 


3 
3 
3 
3 
3 
3 
+ 


zeWorking Catalog-eSource Library: 


z NG CD RD CREE TED CI GN GND AAD GOED Vet OED EORAD ANTE ED ald ED nee COND Cee RE AD OOD aD ME OE GR AO OED OD OE 2 


} 66 08 ce ce se se ce 


Deck A does not axist on 
this tlbrary at this time. 


ee 08 28 86 86 a6 


ie CE OS A EE AG AE ND AR GA ED UO OD OD OD WE Weed Ded) ince TERE AO ce eee END ES Ye ee one . 


Deck A was transmitted back to 
the Integration catalog. The 
deck could be re-extracted at 
this time. Note that the date 
and time associated with the 
interlocks here are the same as 
those associated hetween the 
source Iifbrary and feeture cat~ 
alog source libraries In the 
previous diagram. 
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4 
oer ee en Vom Sen ne sae tae TaD a 2D Sen ET SO me Re Mae nie silent wom ree woe fe 

Se INTVE.»pi_lOn.Source_ Library i This diagram shows the result of 
3 ae ae ee an a an a en a ne me eam Ne ome mm ane ave aaron me 8 the latest changes fille heving 

3 Deck A 3 been combined with the main 

3 ee ote se sm ee see am 3 source library. This automati- 
? Original 3 cally occurs every rorning and 

$ Interlock: none 3 Is the responsibility of the 

: Sub 3 integration groupe 

* Interlock: none 2 

] 2 

fp se re a a me ae a eer a rae a a ae ad en a coe aw ee fp 


ne a sn nn so a ne cn See en mt em ot he hn a ee in oe 
t,INTVE.Df_On.Latest_Changes 3 
2 mone me ne ae a ae emer ame ene ao mee ae once ene serena an ane ae 
: : ' 
3 3 
: Empty source flbrary 3 
: 2 
2 3 
: 2 
: 3 
4 re ae a ae re em eee ae ae eee noe mee mene meme a op 
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3.2 MODIFICATION ORGANIZAILON 


2e2Z0e1 MODIFICATION CONVENTIONS 


Each change made to a dack or a group of decks an an SCU tibrary 
Is assoclated with a modification name. Every modification header 
should have information containing the author's name and a 


description of the purposa for the change. 


The follewing conventions for medifications are proposed: 


* Modifications for PSR's must be named by the PSR number 


wherever possible. If this Isn't sossthtes or 


if the mod 


answ@rs mora than one PSR» the PSR number(s) must be in 


the description. If the name is the numbers 


it should 


still be In the descriptions where space permits. If a 
BSL Is associated with the PSRs the DCS number must be in 


the description. 


° Mods for a spacifie NCS decument such as a RAP should = be 
named by a form of the DCS number. If the project has 


another conventions or If there are many mods 


associated 


with the documents the descrfotian must contain the DBCS 


number. 


® If there are saveral mods for a features the description 
of the tast mod transmitted hefore Evaluation besins 


testing of the faature must begin with the word 


wFINAL®™,. 


A memo or nota should also be sent to the responstihie 


evaluator. 


e DescrIptions of modifications which are not 


PSRts oor 


external features must begin with an exclamation point. 


Following the exclamation point must be a 


keyword 


Indicating the type of modification. We propose the 


following kaywords3 


PERF - This signais that the modification is Intended to 
imerove performance, Performance enhancements which 
are PSR rasponses must follow the convention for 


other PSRs, 


D0C - This indicates that the modifications are to 


internal documentation. 
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FMT - This applies to all modifications made to Improve 
readabillty of the source code. Cybformings addition 
of titles and page ejectss and many deck name changes 
would be made by this type of nodification. . 


PROJ - This would Identify changes te code which will 
never be raleasead. Such code would Include debugging 
statements and project utilities such as tebhle 
aeneratorse 


Other keywords will no doubt be added to the Iist. 


® Bua fixes which area not PSRItd will not be tagged by an 
exclamation marke Wherever nossibles howevers PSRIs 
should be written. 


e The bulld contant raport will fist the decks modifieds so 
the description does not have to do this. 


° The descriptions, beyond the tag dascribed aboves should 
be a clear description of the changes madee Complete 
sentences ara recommended. 


® The author field must he Fliled In. Since the 
MADE_ MODIFICATION procedura sets this to the value 
specified by the SETWE proceduras this is no hardship. 
The full fast name Is preferred to Initials or user name 
onlye 


3e2e2 USAGE OF FEATURES 


If a project wishes to group certain modificationss each 
modification can be assigned to the same featuree Conventions for 
feature names have not bean set ups so the project can chocse their 
own namese 


Tf a modification doas not have a feature associated with it by 
the time It Is going through an Integration builds the integration 
group will give it aé#$feature name RUILDLXXXX where XXXX Is the 
current oroduct set build level. 
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32203 STATES 


SCcu. states will be used to indicate the degree to which a 
modification has baen tastad. Integrations being the owner of 
INTVEs will have sole authority in upgrading the state codes higher 
tran state 1. 


State © ~- "Under Davel opment! 


Code with state O modifications residas in the feature and 
working source libraries. State 9 Is used on an 
Integration source library to designate a modification 
that has bean rejected. (This rejection process needs to 
be defined by Evaluation and Integration.) 


State 1 = 'Tastabliea! 
Code and test modifications will be transmitted to the 
system source library at state 1, This code has 
successfully passed the unit tests and is now ready to be 
incituded on the develooment system. 


State 


hs 
8 


'integrated!? 


Code with state 2 modifications has been formally 
integrated Into the bese system by Integration. 
Quickliooks are executede §§ Evaiuation executes the 
regression and feature testhbases,. 


State 32 - *Retease Candidate? 


Code wlth state 3 modifications has passed a set of 
criterta (2s Je stability, performances documentation 
er|terla) spactfiad In the test olanse (This approval 
process nears to be defined hy Evaluation and 
Integration.) The system is installed In closed shoo, 


State 4 = 'tRaleased? 


Code with state 4 modifications has heen formally 
released, 


Thare wlll he no state Oo modifications on the INTVE source 
library with the oossible exception of those that have achieved 4a 
higher state and then been rejectad for some reasone 
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303 VERSION REPRESENTAIZIN_QE_AN SCU_LIBRARY 


Each source library in the INTVE catalog of the product set will 
contain a version reprasenting the bulld level of which the IJibrary 
was fast bullt for tha closed shop systame The lavel will be 
contained in the header field of the library. These tleve!l numbers 
are changed by the integration group. 


3e4 COPYRIGHT CODE 


Copyright notices ara raguired to be part of avery CDC software 
product. The source code for each product must Include a copvright 
notice as comments within the first twenty fines such that the 
notice appears with the name of the product. The comments should be 
placed within the module which Is initiated first (where the 
starting procedure rasides). For products where this is not 
apollcables olace the copyright comments In the first alphabetic 
module. This Information must also be contained in the resultant 
hinary of the product. The Cyber 175 convention is applicables 
}.2, 


COPYRIGHT CONTROL DATA CORPORATION 19x x 


Tt is the development project's responsibility for generating and 
transmitting code to Inelude the copyright information In the 
SOUr CR. Annual changes to update to the current year Is not 
reauired. Integration places thea copyright information into the 
product's bound binary module comment field. 


For further Informations, refer to the CDC procedure on copyright 
ownership noticess policy number 1060:08:013:011. 
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4.0 TOOLS 


There are ao few iJidsraries available which contain helpful 
procedures for averyone to access. The following is a list of these 
tibrariess how they are accessed end a fist of the tools they 
crovide. 


“el SVESTOOLS LIBRARY 


LIBRARY: svfttools_library 
ACCESS: Library Js automatically in the command list when 
logged onto NOS/VE. (Avalilabie only in Sunnyvale) 


More Information about the tools listed below can he obtained 
from tha DCS documentsS54762. 


TOOLS 


BANNER 
RURST_COMPILATION_LISTINGS 
CHOOSE 

CQUNT_LINES 

CYBXREF 

FORMAT _STRING 

scoop 

SELECT 

SENATOR 
SETLMAXTMUM_STACK_SIZE 
XEDIT 

ALARM 

CHANGE_FEATURE 
CHANGE_GLOBAL 

CHANGE _GROHP_NAME 
COUNT_ACTIVE_LINES 
DETACH_UNIQUE_FILE 
NTSPLAY_ALL_PERMITS 
NDISPLAY_CATALOG_CINTENTS 
NISPLAY_MODIFICATIINS_BY_STATE 
NISPLAY_NEW_MODIFICATIONS 
ENIT_DESCRIOTIAN 
EXPAND_SOURCE_FILE 
EXTRACT_PROC 
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GENERATE BUILD_CONTENT UREPORT 
GENERATE SELECTION_CRITERTA 


HARDCOPY 
INTEGRATE MODIFICATION 
PRINT 


PULL_UMODIFICATIONS 
PUTLLISTINGS_ON_SOURCE_ LIBRARY 
REPORT_MODIFICATION 
SETLPRODUCTLCATALOG 
UPDATE_LPROOUCT 
DISPLAY_USER_COUNT 
LISTIBASE 

PLOTLUSERS 

NUMP CATALOGS 
DISPLAY_FILE_USERS 
COMPARE DATES 
COMPRESS_DELETELLISTING 
SCREEN 


4o2 SES/VE_TOOLS_LIBR48Y = _ RELEASE 21 


LIBRARY: SES/VE tools library 
ACCESS: Sat _command_list Add=.sasveestfstools 


IQOL_ QRESCRIPILON 

CHANGE_LREMOTE_FILE Chanae NOS File access 
parameters 

CHECK MAIL Checks NOS SES and NOS/VE 
malibox files 

CREATE_LNEWUMATLOOX Reinitializes your NOS/VE 
mal ltbox 

CREATF_LREMOTE_LFILE_PERMITS Sets Nos file access 
permissions ; 

NELETELREMOTELFILE Purges NOS files 

DISPLAY ACTIVE USERS Displays currently flogged = on 


NOS/VE users 
NISPLAY_NOS_CATALAG Displays a NOS catlist 


DISPLAY TONL HELP Displays parameters and 


4-3 
Integration and Development Guidelines and Conventions 
| | | 07/11/85 
4.29 TOOLS 
4.2? SES/VE TOOLS LIBRARY — RELEASE 1 


explanation of a tool 


MISPLAY_ TOOL STATUS | Displays a selected teolts 
“current status 


EXTRACTLLINES Writes Sines from an input file 
to an output file If the line 
contains the chosen string 


EXTRACT USTRING Writes strings only from an 
Input file to the output file 
if the string is found In the 


input file 
FORMATLITEXT Runs the NOS TEXTPRO package 
GETUMAIL Gats entries from NOS SES = and 
NOS/VE mailboxes 
GETLREMOTE_LFILE Acquires a NOS permanent file 
GENERATE _LARGE_BANNNER Puts a large tletter banner at 


the beginning of a file 


HELP Gives access to the SES/VE 
tools fibrary online user 
manug@ls the NOS/VE messages 
manuals etce 


PRINT LU BANNERED_LFILE Prints a File which has banner 
| Information iInctuded 

PUT LINE USING Produces formatted SCL output 

REDO COMMAND Re-axecutes previous Sct 
commands editting allowed 

REPLACE_REMOTE_FILE Replaces a NOS permanent file 

PETRY COMMANDS Re-executes a sequence of 
commandss editting allowed 

RUN_CADS GRAPHICS Executes the NOSJVE CA0SG 
package@e (This cannot 
currently be accessed because 
of a Fortran comoller 


problem.) 


RUN_LINK_J08 Causes a file to be transferred 
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to NOS to be executed 


RPUN_NDS_J08 Causes a file to transferred to 
NOS to ha axecutads, or to anv 
other linked NOS machine 


In order to access more information regarding the tools I!tilsted 
aboves enter the HELP conmand after doing thea SETCL 
A=eSESVE.STFSTOOLS. 


4.3 OTHER USEFUL _IO0L_LISR ABIES AVAILABLE 


Another useful Jlbrary which contalIns tool orocadures Is the 
ésystemeosf$site_command_library. This Is automatically available 
to anyone who is tlogyad onto the NOS/VE operating system. The 
commands will not be listed here because there are so many and they 
are used by several different grouos or projects. The user can 
disptay the commands and access them if needed. 


The Yibrary which contalns the orocedures for development to 
maintain thelr product's source library is eINTVE.»COMMAND_ LIBRARY. 
To aceess this tlbrarys the command» "Set lprogram_attributes 
Adde.INTVE.COMMAND_LIBRARY™ Is axacuted. Usuativs this command is 
added to the user's vroloyg file. 


Section 6 discusses thase procedures in more detall and includes 
several examples. 
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5.0 NEW PRODUCT CONSIDERATIONS 


Sel PRODUCT _ HEADER INEDRUATION 


The following information about a product's tftevel and. = version 
number represents Section 3.341.5 of the Cyber 180 System Interface 
Standards DCS documant $2195. Product's which are run Interactivelyv 
should also conform to these standards. 


Belel PRODUCT VERSTON NUMBER 


This number Is in the form 9.99 and represents the ovproduct's 
release version. For release lele3de the version number for each 
product are as follows! 


Product Version Number 
AAM 1.1 
APL 1.¢ 
ASSEMBLE 1.1 
BASIC 120 
COBOL lead 
DESUG 1.2 
EDIT CATALOG 1.0 
FMA lan 
FM 121 
FORTRAN 1ei 
HELP UTILITY 1e2 
LISP 1.1 
PASCAL 1.0 
PROGRAMMING ENVIRONMENT 1.0 
PROLOG 129 
SORT lel 


ZEUS 1.9 
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Feled PRODUCT LEVEL 


Fach product which calis CCM to generate a tistina must sat the 
com variables» ceov$instalil_date and cevtproduct_levels», to the jJullan 
date of compllation of the product. To acaulre the jullan dates the 
product needs a module which stores the current jJullan date In thelr 
own variable. The value of this variable is then given to the ccm 
veariablese The modula can either reside on the product's source 
library or can be created and compiled within the build procedure. 
An exampie from a bulld procedure is? 


COLLECTLTEXT Insteli_data_complle untij="**!' substitution mark=!7! 
MODULE pim$bulld date; 
VAR 
pivgbulididate: EXDCLI string (3) t= 
2$sustrisddatealordinal)s, 3s 5))%13 
MODEND pimfbulld date; 
2 


where pi is the product identitier. 
Products which do not call CCM, but oroduce a header tina when 


axecuteds, must include the build date in the header linee Other 
products should put the build date to the job loa. 


Se2 QUICKLOOK_ TEST TRANSMITTAL _ GUIDELINES 


If a oeroduct is going through the process of transmitting thelr 
code to integration for the first time and the evaluation group Is 
not prepared to test the products, the project must supply a smal 
test called a quicklooke 


Tf the new product can run hatch Jobs» there is a file avallable 
which Is atemelate for ai auickleook test. The file name Is 
eSviqi.aquickliook_temelate and this can ba copled into vour own 
catalog and edjitted accordinaly for your product. 

The file Is Jisted below. 

AO oo io ae to tok foi tok dk dea a oo oi toi ek i og a tok foi i 


JOR Job -nemesxxx 
"XXX Is the job names This is usually the same as the test namee” 


create_variable name=stats kind=stetus 
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create variable trouble _flaq kind=hoolean valuesfalse 
IF $variable(ttv#actions declarad) = TUNKNOWN!' THEN | 
create variable tty#action kind=(strings tmax uname) sconpe=job .. 
value=ztKILL' 
IFEND 
IF Svariable(ttv#test tool Ilbrarys declared) = "UNKNOWN! THEN 
create_varliabie ttv@atast_tool_f!ibrery kind=string scopezjob e. 
value="3$SYSTEMeSSYSTEMVETOOL .TTFETESTLTOOL_LISRARY? 
TFEND 
BR eee 0 Oe Oe Oi 0 0 DE DE ES OD ED th TS SO OND “ne A nk SENT “HD AEN eR ee te ORD Ue ED HORS OS a Oe ep ED ee ee ae ee ee ee en ee ee 
" acquire test tool tibrary ™ 
” Firsts ramove any prior usages 
set program attribute delete _lfbrary=tlocal.ttfStest_tool_illbrarv.. 
statuszstats 
set_command_list delete=Slocai.,ttfttest_tool_library status=stats 
detach _flle files$local~ttfstest_tool_jJlbrary status=stats 
attach file faS$fnama(ttvétest_tool library) .. 
ifnettfstest_tool_llbrary am={read execute) .» 
sma(read execute) wait=true 
set_command_list add=Siocal.ttfstest too! library 
setlprogramvlattribute add_llibrary=Slocal.ttfstest_tool_library 
TO ccs cies cises cecn ‘eeu chsou ih tac: coum com: usb 01 cae aes eis sesh Ais nts pth see Se Sees “duets Geb slaw ‘evi ah es ei Sn bm ‘ges Ses ces las UN suis Semmes mum ta amb segs Wes tm ts ms > en Sue Qapw ‘oe u ie e e  s 
automated chacking_routina pi=2z22z statuszstats 
“z77 Is the three-letter product Identifiers i.@. AA@® is the identifi 
"for the AAM product.” 
display_message massaga='CONTROL DATA COMPANY PRIVATE? oe 
status=stats 
automated checking routine tn=xxx status=stats 
"yxx Is the test nama.” 


COLLECT_LTEXT output=taxtianp uNntil=tENDO _COLLECT_TEXT? statuszstats 
orogran "This Is the program you provide to test your oroeduct. 


END _ COLLECT _TEXT 

WHEN any fault DO 
trouble flag = true 
display message massaye2ztAN ERROR HAS OCCURED! status=stats 
display catalog catalog=Slocal 
display value valuesusvostatus outeout=toutput 
display_program_attributes output=$outout 
automated _checking_routine state=zfall statuszstats 

WHENEND 


"The next line would contain the compilation command for your oroaram 
w~ J.e. cobolsi=taxtinpslz=outputs lozspsauditztrues bzbinarvl 


"The next fine wouid contain the execute statement, eee an igo or 
axecute_task binaryl Im=Soutput Imoz(s b ep) 
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COLLECTLUTEXT outputszout until="DESCRIPTION_LEND? status=stats 
TESTLNAME? xxx 
PRONUCTLNAME?3 xyz 
ARSTRACT3 
DESCRIPTION: 
FEATURES 
DESCRIPTION_END 
automated icheckingy_routine actlon=Sname(ttv#action) 
JOBENN 


SOO do do oo ooo doi tok tok io oitok ibokoiok dak tek doko gk 


The program orovided must be easy to analyze and test a few 
features of the product. The output from this program must contain 
a version number. See section 3.3 for more Information on version 
numberse 


If the new product Is normally only run tnteractivelys then a 
simple interactive Job must be supplied which wil! display the 
product's version number and wiil display ai distinct passing or 
failing status. 


OQnee you have oeraparéd a aulckliook job for your products this 
should be given to tha evaluation group to Include the test In the 
quicklook library. 


The purpose of tha quicklook tests is to varify that the products 
have been Installed correctiy. The tests are run by Integration 
following the completion of product set bullds. 


Se3 VERTEICATION JO3_ TRANSMITTAL 


Every product must provide a Job to quickly verify the product is 
Installed. This Job differs from the quicklook test In that It is 
an extremely short tast to verify that the product Is callabte. It 
is not designed to test any of the product's featuras. 


The following Is a List of guidelines for a verification job and 
an exampte of an alraady existina Job for the cobo! voroducte 


Guidelines 3 
e Put the Job Into procedure form which will be called 


interactively. 
e Do not use any other products. 
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® Do not us2@ any jJocal tools. 


; Keep It "short and sweet", Just the bare minimum to 


verify the existence of the product. 


e Make the test results obviouse Put commants in the job 


log to make tha test self-explanatory. 
® Do not includs error processing (WHEN loans). 


Job abort at error. {This Is the current direction; 


may change later.) 
° Name as follows: INSTALLATION _VERTFICATION_xx8 
xxeproduct identifier. 


Fxrample 3 


job Job unamezinstallation_varitication cbs 


" 
"” 


223 8 


This is the installation verification procedure for COBOL 
Method ==> 


1. Create a tiny CO30L program using collect text command 
2e Cali COBOL compila statamant to comoile this perogram 
3. Execute the binary of this pregram 

4, 'COBNL Is Installed 1* should be displayed to $OUTPUT, 


create_varlable (file connection statuss verifvistatus) kind=status 


COLLECTLTEXT output=cobollprogram until="COBOL_PROGRAM_LEND! 


identification division. 
program—id. call-cobol, 
environment division. 
data division. 
procedure division. 
the-only~—paragr aph. 
display "CO830L is Installed '™ 
stop rune 


COBOL _PROGRAM_END 


dalete_file -connection standard _filezSerrors file=output .. 


statussfile connectlonustatus 
cohol, iszcobol_programs b2=cohbol_igos izttlocal.listingeSeo} 


TF file connection ustatus-enormal = true THEN 
create _file_connection standard -fillesterrors filezoutput 
TFEND 


axecute_task cobol_igo termination lerror_levelsf statuszverify stat 


detach _flle filez=(cobol_ tga, cobol_orogram) 


EXIT PROC WITH verify ustatus 


jJobend 
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The verification Job should be aiven to Integration when the 
product Is transmitted for the first time. 
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609 A_GUIDE TO USING THE DEVELOPMENT ENVIRONMENT 


The fellewing is a auide to using the Develooment Environment 
procedurese It describes the most commonty used features, which 
should be suffictent for most situations. 


Sel WHY_USE_ THESE PROCEDURES? 


The purpos2 in using these procedures is to provide a consistant 
mechanism for Development and Integration to craate and control 
modification of code. Conventions are enforced by the design of the 
procedures. The manual overhead of using NOS/VE and SCU is reduced 
by automatic creation of new cycles and the use of SCL varlables to 
define user controllable defaults. You are required to use the 
EXTRACTLSOURCE and TRANSMITLUTOLINTEGRATION oroceduress since these 
enforce deck Interlocking. It is your option to use the other 
orocedur ase 


662 INITIAL PREPARATION 


Tn your prolog, you should have two commands which set up the 
development anyvironment. The first makes the procedures available. 
This command tis: 


sat _command_I}brary add=-eINTVE.sCOMMAND_LIBRARY 


The second Is tha SET LWORKING LENVIRONMENT command, It creates 
the SCL veriables which define your environmente The following 
command is an example, 


set lworking_eavironment author=!V. F. Userte. 
product name=PI_O0S oe 
bullid vlevel=NONE working _catalog=SUSER 
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In the examples the master tlibrary for the product will be 
acaulred from ,INTVE.Pi_G5.SQUPCE_LIBRAPY, Your working IlIibrary 
will be acquired from SUSER.SOURCE_LIBRARY. If it dees not exists 
tt will be created the first time you execute a procedure that needs 
to write to It. If you create it yoursel]fs make sure that you leave 
eycle one unused. This cycle Is used for temporary hotding of the 
result Jibraryv. You must give yourself additional permission to 
your own library. This can he done by the following command: 


create _ file _parmit SUSERs*SOURCE_ LIBRARY ams(all cycta ee 
control) sm=none apolication_information="I4! 


This edditional file permission should also be given to your 
feature cataicg source library if you have one. Be aware that 
sometimes the master catalog permissions override the file 
permissions and this will cause problems. For examples If you have 
a master catalog oermit for a particuler user with restricted 
permissionss this will override a file permission for the group 
public. 


The APPLICATION_LINFORMATION parameter is the additional 
permisstione {ft tells SCU that you can set interlocks an this 
jlbrary and manipulate mods at stete 4. The parrmit on the master 
fibrary in INTVE should be ‘'T1'. Integration will insura the 
corract permits In the INTVE catalog. 


6e2 CHECKING OUT_A_DECK TI_MAKE CHANGES 


You use the EXTRACTUSOURCE command to get copies of decks from 
tha master tibrary to your featur2 Tibrarye If another user has 4 
deck chacked outs you wili not be able to acquire Ite If you are 
using a feature catalogs a copy of the deck will he put there as 
weil, 


The procedure looks first on the feature librarys If anys then on 


the deck. (The LATEST_CHANGES file Is regularly combined with the 
master tibrary. For EXTRACT SOURCE you can think of the two flies 
as one.) The deck is then extracted from the Ifihbrary In which It 
was founds and combined with tha feature librarys, if anye It is 
then In turn extracted from tha feature library and combined with 
the working tibrary. <A new cycle is created of the working § and 
feature tibrartas. 
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Before concludings the proe logs the names of the decks and the 
Files on which thay were found and out to a File catted LOGGING tn 
the INTVE product subdcataloy. 


604 ENTERING LYE WORKING ENVIRONMENT 


Qne easy way to use SCU to maka changes Is through the working 
anvironmante Executing the ENTER WORKING_LENVIRONMENT command puts 
you in SCU command modes with the high cycle of your working library 
as the BASE and cycle one as the RESULT. You can now anter any SCU 
command and most Devalopmant Environment commands. 


When you are finisheds and you want to save your changes» enter 
the EXITL_LWORKINGLENVIROHMENT command. This will write the library 
to cycle ones end SCUs, and make cycle one the new highest cycle. 
The retention period of the old high cycle will be set to ls» to keep 
File space from overflowing. 


If you do not want to save the changes» enter END NO. This will 
end SCU and cycle one will be deleted. Pe careful to enter EXIWE If 
you want to save your changese To "checkooint™ vour tIlihrarys usa 
the WRITE_LLIBRARY command. ENTER_LWORKING_LENVIRONMENT wild output a 
message if cycle one already exists. 


6-5 CREATING A_MOOTELC ATION 


You should use the MAKE_LMODIFICATTON procedure to create a =*new 
modification. This procedure will use the Author value specified by 
SETWE»s and requires a feature name and description. If you are In 
the working anvironments, the modification will! he added to the 
working Yibrarye If you are not In the working environments a naw 
cyele of your SOURCE _LIBRARY will be created. 


604 RETURNING A_MODTETED_vECK 


When you want to return the decks you checked out with 
FYTRACTLSQURCEs you use the TRANSMITLTOLINTEGRATION procedurae Tf 
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60S RETURNING A MODIFIED DECK 


you are using a feature catalog» you first have to use the 
TRPANSMIT_TO_LFEATURE_CATALOG procedure. This procedure combines the 
decks spacified with tne existing feature librarys and removes them 
from your working library. 


TRANSMIT_TOLINTEGRATION removes the decks from your feature 
ifibrary If you have ones or your working Ifbrary if not. It 
combines them with a file called LATESTUCHANGES»s which is In the 
same catalog as your master SOURCE _LIBRARY, LATEST CHANGES is 
combined with SOURCE LIBRARY automatically after deadstart. 


You can specify decks, modifications» or features to be 
transmitteds but tha effect Is always that affected decks are 
transmitted. If you specify a modifications all decks changed by 
that mod are transmitted. In additions new mods not specified will 
be Included. All mods a?facting the transmitted dacks which are at 
state O will bea changed to state i by TRATI (hut not by TRATFC). 


A list of the decks transmitteds with the mods changed tn states 
Is written to the LOGGING file. 


Se? EXAMPLE 


The following example shows a simole use of the development 
environment procedurese Tt is assumed that the 
eINTVEsCOMMAND_LIBRARY file Is In the command fists and thet a 
SETLWORKING_ ENVISONHENT command has bean executede 


extract _source pim$a_dack_ofucybil source 


entwe “ From here ons you will get a 'we/t prompt. ” 
makm m=PIBAQ11 featura=bujId_04CO md=' PSR fix for abort In ee 
listing generation when cross reference selected,! 


edil mepi8a0ll deoliata_deck of cybhil source 
2 
Editor commands to modify the deck, 
2 
END " ar function key In screen mode " 
dism pi8a01l 
"SCU commands can be executed Inside the environment” 
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exiwe ”™ creates anaw high cycle with the modification 


format_cybil_source w=pi8a011 d=pim$a_deck_of_cybil usource 
"creates another cycles, since outside the environment 
* This command is optional. 


tratl d=pimta deck _of_cybIl I source 


Of courses you would compile the deck you modified and test it 
before transmitting it. 


603 BAKING CHANGES WITHOUT _USING THE SsCu_eoigoe 


You can make changes to a deck In other ways than through the SCU 
editer by using the GET_SOURCE and REPLACE SOURCE procedurese 
GETL-SOQURCE extracts a dack and writes it out $=In tegible format. 
REPLACE SOURCE compares a tegible fille with a deck en the vorkina 
library and ganerates a correction sete 


GETLSOURCE can he used for many other purposes. For this 
purposes, you must specify FEATURESsALL and 3UTLOLLEVEL=NOQNE to gat 
al! active tJinese Otherwises GET SOURCE may exclude some 
modi?icationse 


This method of making changes Is most useful when using tools 
like GENERATE_ PDT and EMHERATE_COMMAND_TABLE_MODULE. GENPDT. for 
eaxamoles, accepts as Input a POT definitions which is very similer to 
an SCL procedure header. Its output is a file contaltning CYSBIL 
declarations for the parameter descriptor table. The original input 
Is tisted as commentary. 


The following example shows the use of GETUSOURCE and 
REPLACE SOURCE to modify a deck which contains GENPDT output. As 
aboves it assumes that a SETLWORKINGLENVIRONMENT command has been 
executed, 


extract source pid$paramater descriptor table 


make_modification $5999 _pdt fnew _parameaters 
md=*Add new parameters for DAP §$5999,! 


get_source pidSparameter_descriptor table .. 
sourceszoriginal pdt featuretali bl=none 
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edit file original pdt 
"* extract the POT declaration from the commentary 


generate pdt f=orlginal lpdt c=ner_ pdt 


reolace source source#new pdt oe 
deck=pid$parameter_ descriptor tabla modification=$5999_pdt 


transmit_to_integretion pidSparameter_descriostor table 
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7.0 COMMANDS _T0_USE_IJE_NISZVE DEVELOPMENT ENVIRONMENT 


A Jibrary of commands (mostly SCL serocedures) provides access to 
tha SCU source libraries. Thesa commands use standard facitities of 
NOS/VE and Its preduct sat. 


These commands ara malnatainad on a NOS/VE source Iibrarye Refer 
to Aopendix A for conpias of the actual procedura definitions. 


To access these commands the user must add the command library to 
his/her command list. This is accomplished simpivy by entering? 


Set _Command_List add=.INTVE.Command Library 


To facilitate thiss the set _command_!list covld be added to the 
usar's prolagde As a results, the commands appear to the user to be 
system commands. 


Some of the commands described below wlll create e naw cycle of a 
Filee When this operation would take place on a temporary file that 
file will be overwritten (this is because NOS/VE does not support 
cycles for temporary fiies). When this operation takes place on a 
permanent filles, cycla 1 of the file is first written {as a scratch 
flle) and when this has successfully complateds tha $SNEXT cycle wil) 
be written and cycia 1 purged. In this way the integrity of the 
SHIGH cycle of the library should be matntained. To facilitate 
thiss users are@ asked to keep cycle 1 of their Source Library file 
unused. The retention pariod of the previously high cycle wil be 
seat to onee Expired cyclas wil! be deleted dally. 


The deleting of old cyclas of source libraries from feature and 
working catalogs Is the responsibility of the associatad 
project/usere It is strongly recommended that cycles he monitored 
closely and purged reyularlys» as cycles can accumulate rapidly. 
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7o1 ENVIRONMENT com 


ANOS 


The commands described in this section are used to specify the 
“enyvilrongent™ in which work wlll be done. NOTE : Ald keyword 
specifications and default earameter vatues are defined In the 
Command Summary (Appendix A). 


Particular parts of the environment can bea specified on most of 
the commandss but the commands are much more conveniant to use if 
the anvironment parameters area established prior to work starting 
{via the Set_Werking tavironwrent command). 


Normatiy the SETLUWORKINGLENVIRONMENT command is called fro 
within the user's prolog thus establishing the environment at each 
logine 


Nther commands that care abcecut an environment parameter willl 
default that paramater to the value spacified on the 
SET WORKING ENVIRONMENT command. If that command hasn't been 
called, the default used is that specified in the description of the 
corresponding parametar of the SET_LWORKIRG_ ENVIRONMENT command. 


Although eventually all of the commands 
described in this document will be sensitive to 
whethar tha working environmant has been 
"entered", Taitially the only commands that will 
operate both “Inside” and “outside” the working 
environment are COMPILE-SOURCEs GETLUSQURCE, 


REPLACELSOURCEs ASSIGNLUMODIFICATIONs 
MAKE MODIFICATIONS ENITUSOURCE, and 


FORMAT _CYBIL_SOURCE. 


This Is analogous to the current system of using profile 
variahbies as defaults In the 170 SES environment. 
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Teolel SETLWORKINGLENVIRONMENT (SETWE) 


This command is used to create or change command fanguage 
variables that snpacify the level of system or product to be used as 
a basis for work and the “feature™ and "“workina™ catalogs being 
used. The parameters specifled in this command can aitso be 
specified on ALL of tha other commands described in this document. 
The defaults for thase parameters are the same In each command. 
Howevers once values for them have been established by the 
Set_WorkiIng Environment commands they need not he specifled again 
unteass the user wishes to acces a different catalog or hulld tevel. 


Omisston of a parameter wllJI cause a default value to be picked 
if the corresponding variable is undefineds, or If defined the 
corresponding value will be laft unchanged. 


All command language variables set by this command will have a 
scoce of J0R and their names wlll hegin with the characters WEVS. 
The variable names used are specifled with the corresponding 
parameter. 


This command {ts normally called from a user's prolog. 


set _workina environment Cauthor=<string>] 
Ceproduct _names<namad] 
Chulid vlevel=<nanad] 
Ctools library vbulid_level=<name>d) 
{feature _catalog=<catalog>] 
Cfeature_bulld ulevel=<name>] 
Cworking_ catalog=<catalog>] 
Cworking build lavel=<name>] 
{[status=<status variable>] 


author } a !? specifles the caller's names to be recorded as the 
author of any decks or modifications created by this user. 
The corrasponding variable name is WEVSAITHOR. 
Omission causes the usar name of the caller to he used. 


product name {+ pnt: specifies the name of the product to be worked 
one This is the nama of the operating system or product 
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subcatalog In tha main Integration catalog. 
The corresponding variable name Is WEVSPRNRUCT_LNAME, 
The default is 95. | 


bulld lfevel i bio: specifies the name of the system or product bulld 
feval to be used as the basis for work. 


The corresponding variable name Is WEVSBUILDLLEVEL. 
The default is tha latest system build level, 


tools library _bulld_level : tib!l 3: used for 9S development only. 
Sunnyvale uses shoujd set thls parameter to NONE, 


feature catalog ? fo 3: spyacifies tha catalog in which the filles and 
subscatalogs corresponding to a feature are located. 


The corrasponding variable name Is WEVSFEATURE_ CATALOG. 
The default is to have no feature catalog {a value of "NONE?), 
feature_build lavei {| fbi 3 specifies the name of the feature bulld 
fevel to ba used. This is analegous to the system or oroduct 
build tevel but designates the version of the feature to be 
used. The initial implementation of these commands will 
support oaniy one “feature bulld leavel”™. 
The corresponding varlable name Is WEVSFEATURE_BUTLO_LLEVEL. 
The default is OBJECT. 
working catalog % we 3 spacifies the catatog In which the filles and 
subcatalogs corrasponding to a develooers current work are 
located. 
The corresponding variable name ts WEVSWORKING_CATALOG. 
The default is to have no working catalog (a value of NONE), 
working _bultdvolevel { wbi % specifies the nare of the working bulld 
Jeveal to be used. This Is analogous to the feature hulld level 
but designates tha “working” version to be usede The initia! 


implementation of these cammands willl support only one “working 
bhulid Jlavel™, 


The corresponding variable name is WEV#&WORKING BUILD_LLEVEL. 


7~5 
Integration and Development Guidelines and Conventions 
eae oe . 07/11785 
729 COMMANDS TO VSE THE NOS/VE DEVELOPMENT ENVIRONMENT 
JFelel SET_LWORKING_ ENVIRONMENT (SETWE) 


The default is OBJECT. 


status : see NOS/VE error handling. 


Tele2 DISPLAY_YWORKING ENVIRONMENT (DISWE) 


This command displays the values of the working environment 
parameters that have been estabilshed by Sat_Working_Environment. 


display _working_environnent Cdisplay_loptions=list of <name>] 
Coutput=<file>] 
[status=<status variable>7 


display option {| display loptions { do : soecifies which working 
anvironment paramaters are to be displaved. The legal velues 
for this parameters ara the names of the working environment 
parameterss and their abbreviations», as specified fer the 
set working environment commands plus the keyword ALL meantng 
display all working environment oarameters,. 


Omission causes ALL cto be used. 
eutout $ @ 3 specifies the file to recelyve the display. 
Omission causes $OUTPUT to he used. 


status 3: see NOS/VE error handling. 


7ele3d ENTER_LWORKINGLENVIRINMENT (CENTWE) 


This command should be used when a number of changes need to be 
mada to tha working source library. It calls SCU such that the base 
psrameter Is the sourca library In thea working catalog and the 
result parameter is a new cycle of that source Ilbrary. 


This command provides a mora efficient way of doing work than 
"popping in and out” of SCU to do editings deck expansions ete. For 
axampile, auser may enter the SCU utilitys, make some changes to a 
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decks, complie It (without having to exit SCU and thus write a new 
cycle of the working iibrary), fix whatever problems may show up In 
the compiles complia agains etc. Qniy when finished with that 
particular work session does the user need to feave SCU. 


Checkpoints of updates to the source tJlibrary can be made via 
SCU%s WRITE_LLISRARY subcommand. Be sure to include the file name of 
the desired resultllibrary on the WritelLibreary commands or the 
result will be a temporary scratch fila. 


The session of work can be terminated via a corresponding call! to 
EXIT_WORKING_ ENVIRONMENT which will write the new cycle of the 
working source library. 


anter_working_environmant [author=<string>] 

Cproduct name=<named] 

Cbhulld level=<namea>d] 

{feature _catalog=<catalog>] 
Cfeature_bulld leval=<name>] 

Cworking _catalog=<cataiog>] 
[working build _level=<name>] 
Cstatus*<status variable>] 


author { a: specifies tha caller's names to he recorded as the 
author of any decks or modifications created by this usere 
product name } pn 3 specifies the system or product to be used. 


bulld_tevel i bi t specifies the system or product bulid level to be 
usede 


feature catalog { fe 3: specifies the feature catalog to be used (if 
any)e 


feature _bulid vlavel ! Fbhi 3: specifies the feature bulid level to be 
used. 


working _catalo jy { wo 2 spucifies the working catalog to be useds 


working_build_levei { wb! : specifies the working build level to be 
usede 


status % sea NOS/VE error handling. 
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Fele4 EXTTLWORKING LENVIRONMENT CEXIWE) 


This command is usad to axit from the working environment created 
by a preceding call to the ENTER LWORKING_ ENVIRONMENT command. 


If changes have bean made since the working environment was 
“entered™ the new cycla of the working source library is written. 
If no changes were mad@y the new cycle is discarded. 


exitlworking_environment C€statuse<status varlablte>] 


status : see NOS/VE error handling. 
7.2 COMMANDS FOR _CODE_DEVELOPMENT_AND_INTESRATION 


The commands described in the following subsections are Intended 
to be usad hy developers (and avaluators In their role as developers 
of tests) and integrators to access svstém orlented sources 
Parameters to these commends are the same as corresponding 
pearamaters in standard system utilities such as SCU and CYBIL. For 
examole the Cybil list loptions parameter can aiso ba used In the 
call to the Compile Sourcs command. 


NOTE 3 Al! keyword specifications and default parameter values 
are defined In the Comaand Summary (Aependix A), 


7e2el ASSIGN_MDOTFICATION(S) (CASS) 


This commana can be used Inside the Working _Environment,. 
Remamber that In SVL the NAKE_LMODIFICATION command {fs recommended 
-and the documentation *ollows this. 


This command creates one or more unlaue modifications in the 
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working source tlbrary. <Any time the usar wishes to create or 
modify aodacks a aodification name must he supplied to the 
appropriate command. This modification must have been created by 
Asslan Modification or must contain atl tEnformation reaulred by 
Assign modification. 


The names for the modifications are created from the 
“modification name seed” assigned to 4 user upon Joining the 
projects and sequence number maintained In the user's prolog. This 
command will update the sequence number In the prologs thus keeping 
track of modification namas already used. 


The user must Initiate this tracking scheme hy entering the 
following two linas in his/her prolog: 


create variable WEVSNODIFICATION_LINDEX kindzinteger .. 
scopes job valuesl (or whatever number desired to start) 


create _varlabla wavimodificatlon_initials kindzstring «- 
scope=job value="xyz_!' (xyz Is userts Initials) 


The new varsion of the saurce tibrary is written as the next 
cycle of tha file. 


assign _modification faatur e=<name> 
Ceoount=<integer>] 
[modification _description=<string>] 
Couteut=<fi led] 
Cauthor =<string>] 
Cworking _catalog=<catalog>] 
Cstatuss<status variable>] 


feature | f ?: specifies the faature with which the modifications are 
to be associated, 

count } c 3: spacifies tha number of modifications to be assianed. 
Omission causes 1 to be used, 


modification_idescription {| md 3 specifies a brief description of the 
modifications. 


Omission causes no dascrinottion to he usad. 


output $ o : spacifies the file to which are written the names of 
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the modifications that have been created, 
Omission causes SOUTPUT to be used. 


author % a: specifies tha creator of the contents of the 
modifications. 


working catalog { we : spacifies the working catalog to he usede 


status =: see NOS/VE arror handling. 


Te2e2 MAKELMODIFICATION (MAKM) 


This command can be usad inside the Working_Environmant. 


This command ts slmlfiar to the ASSIGNIMODJFICATION command 
previous!ty described EXCEPT that there Is no "modification name 
seed". The modification name desired must be specified because it 
is not automatically created. 


The command creates a unique modification in the working source 
library. As with assign imodificatons do not usa this to create a 
madification on the working ‘!lbrary $f the modification exists 
already on the base (eintve.e.) source_!ibrary from which the working 
library was extracted. An arror will not be generated until 
“"transmit-to-integration time" if this Is the case. 


Consistent with tha standards for modificationss the description 
and feature fields are required. 


make_modification modificatlon=<name> 
featura2=<name> 
modification dascription= list of <string> 
Cauthor <string>] 
Sworking_catalog=<catalog>] 
Cstatus=“<status varlable>] 


modification ! m t modification name desired; should ganeraily be 
the PSR number associated with the modificaton. 


feature ${ f 3 specifies the feature wlth which the modifications are 
to be essoclatade 


modification description } md: specifies a brief description of the 
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Te2ee MAKE MODIFICATION (MAKM) . 


modification. 


author { a 3 specifles the creator of the centents of the 
modifications; should contain the creatorts first twe Initials 
and full Jast name. If this field is not supolieds the working 
environment specification is substituted. 


working catalog {| we 3 spsacifies the working catalog to be usede 


status !: sea NOS/VE error handling. 


7o2e3 CREATE_SOURCE (CRES) 


This command can NOT be used Inside the Working Environment. 


This command creates ove or more decks tn all levels of the data 
bas@e Checks are made to insure that the decks don't already 
exist. ; e 


The effect of the cummand Is to create the new dacks In the 
system or product source librarys then to extract the decks to the 
feature level and from there to the working level with appropriate 
interlocks set along the wuaye Once this Is accomolished the text of 
the deck may be added via FEDITL_LLIBRARY or FERIT SOURCE» or 
(indirectly) any other aditor. 


Tre new version of an affected source fttbrary Is written as the 
next cycle of the corrasponding file. 


create_source decksiist of <name> 
modification=<name> 
source. group=<name> 
destination_group=list of <name> 
Coroupsiist of <nane>] 
Cprocessorz=<string>] 
Cauthor =<string>] 
Cdeck_descr lotion=<string>] 
Cexpand=<boolean> ] 
Csame_as2<name>] 
Cproduct name=<named] 
[feature _catalog=<catalog>] 
Cworking_catalog=“catalog>) 
Cstatusz<status varlabla>} 
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deck } decks $ d : spacifies the decks to be created. 


modification { mm 3 soeacifles the modification under which the dacks 
are to be Introduced. This modification must exist in the 
working Ijbrary at state 9%. 


source _oroup i sg 3 specifies the group of decks to which the new 
decks area to be assigneds such as OSS$SOURCE. The name must 
follow thea convention for source groupss ties it must have 
"S$" In the third and fourth positions. (See the section on 
“usa of groups” abovae) 

This parameter Is required 


destination group i: destinatlon groups {| dg : specifies thea filets) 
in which the "processed" (complleds assembieds etce) form of 
the modules is to be placed. (See Appendix 8) If this is not 
applicable (In the case of a common deck) NCNE should be 
specified. If spacifieds, the name must have "FE" In the third 
and fourth positions. 


group i groups } g 3 specifies the ™"erbitrary”™ groups to which the 
decks are to be assigned. (See Apnoendix 8) 


Omission causes no “arbitrary” groups to be assigned, 

erecessor { p 3 specifies the arocessor for the dacks. 
Omission causes CYBIL to be used. 

author $ a : specifleas the creator of the centents of the decks. 

deck description { dd: specifies a brief description of the decks. 
Omission causes no dascription to be usad. 

expand {$ e@ +: spacifies whether the decks are to be "directly 
exoandable” i.e. aritten directly to a compile file 
{expand2=true) or axpandable oniy by being the object of a Stu 
*copy or *copyc text enbedded directive (Cexpand=false). (].@- 
a common deck) 
Omisston causes a default to be chosen according to the syntax 
of tha deck name (each deck will have its own default). If the 
fourth character af the deck name is "S$" and the third 
character Is not "4", the default is FALSE; otherwise the 
default is TRUE. 


same as ? sa : specifias that SCU deck attributes not specified with 
parameters above are to be taken from the named deck. 
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Omission causes the normal SCU defaults to be used. 
praduct name { pnt specifies the system or oreduct to be used. 


feature catalog 1} fc : spacifles the feature catalog to be used CIf 
any)e 


working catalog i we 3 spaciflas the working catalog to he usede 


status 3 see NOS/VE error handling. 


7e%o% EXTRACTLSOURCE (CEXTS) 


This command can NOT ba used Inside the Working Environment. 


This command Is used to extract decks from the feature or 
system/product tlaval to tha working tevel In prenaration for making 
changes. In addition to the decks themselvess the relevant “parts” 
of all associated modificationss festures and groups are extracted 
(fee. SClt's EXTRACT_LSOURCE_ LIBRARY facility is used). 


Tf a deck does not exist at the feature tevel it Is first 
extracted from the system/product level to the feature level, 


This extraction is performed using deck iInterlockss unless 
Interlockzfalse. The interlock name used is always the usar fname. 
If a dack ts extracted without Interlocks it cannot he transmitted 
back to integration or a feature catalog. 


The new version of an affected source library is written as the 
mext cyctie of the corresponding file. 


At least one of the deck and selection criteria parameters must 
be provided. If both are given the deck oarameter fs orocessed 
firste Currently tha selection criteria parameter Is not 
imolemented. 


extract _source Edeckelist of “<named] 

Cinterlock=<boolean>]} 
Cselectionlcriter la=<file>j 
Ceroduct_name=<name>] 
Chultdutevel=<name>] 

[feature _catalog=<catalog>]) 
Cworking catalog=<cataloqg>]) 
Cstatus=<status variablie>] 
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deck { dacks ! d 3 spacifies the decks to be extracted. 


Intertock |} § 3 spacIPies whether decks are to be extracted with ar 
without Interlocks. 


Omission causes TRIE to bea used. 

selection_criterla 7 se & specifies the file containing SCuU 
selection critarta commands that alone or in conjunction with 
the decks parameter select the decks to he extracted. 
Omission causes SNULL to be used. 

product uname = pn: specifies the system er product to be used. 

bublid_lilevel ? blo: specifies the system or product bulld level to be 
used when extracting decks withcut interlock. When dacks are 
axtracted with interlocks al! active JInes are Included. 


feature_catalag {; fc 3 specifies the feature catalog to be used Cif 
any). 


working.catalog ! we 3 spacifles the working catalog te be used. 


status ? see NOS/VE error handlings 


7o205 EDITLSNUPCE (ENTS) 


This command can be usad insida the Working_Envir onment. 


This command is usad to modify a dack that resides on the working 
source librarye — | 


The result of the aditing will seppear on a new cycle of the 
working source library. 


adit source modification=<name> 
{deck=¢nane>] 
Coutput #<fi ted] 
LworkIng_catalog=<cataiog>] 
{Cstatusz<status variable>] 


modification } m : spacifies the modification to be used for editing 
the decks. The modification must exist In stata © on the 
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working library. 
deck § d 3? specifies the deck to be edited. 


Omission wlll necessitate selection of the deck (dack) to ba 
edited from within the editor via the Select Deck command. 


output %$ o 3 spacifles the file to raceive displays from the 
editor. 


Omission causes SOUTPUT to be used. 
working catalog | we ! spacifles the working catalog to be used. 


status : see NOS/VE error handling. 


70226 GET_SOURCE (GETS) 


This command can be used Inside the Working_Environment. 


This command writes one or more decks te a fegible file. The 
decks may be written in expanded (CEXPAND_ DECK) or unexpanded 
(EX TRACTLDECK) form, | 

The decks are taken from the Source Library without Interlocks,» 
thus allowing the usar to Include (Cor exclude) any modifications or 
features desired. This command aliows the user to took at source 
that may atready be interlocked by someone elses for informational! 
purposes ontys or for editing by a non=SCU editor. 


At least one of tha deck and selection _criterla parameters must 
be provided. If both are glven the deck parameter Is processed 
first. 


NOTE: Refer to the description of comeile lsource for the deck 
selaction and criteria file orocessing. 


CAUTION: If you are using GET_LSOURCE to extract a deck which wlll be 
modified and replaced with REPLACE SOURCEs be sure to 
specify FEATURE#ALL and BUILD_LLEVELSNONE. Otherwises some 
modifications may be omitted and not ali active tines 
written to the source file. 


gat l_source Edeck=list of <name>] 
Csourcez<filed] 
Cselectionlcriterias<file>] 
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Cinclude_latest_chanyges=<boolean>] 
Cexpands<booal eand] 

LTCexpans lon_depth=<integer>] 
Caiternate_product=list of list of <name>] 
Calternatea_baseazlist of <file>] 
Ceroduct name =<namne>] 

Cbultd level=<nana>] 
Cfeature_catalog=<cataliog>] 
Cfeature_builld ulevei=<namea>] 
Cworking catalog=<catalog>] 
Cworking bull d lavel=<name>] 
Cstatusz<status varlable>] 


deck } decks } dt: specifies the decks to he written. 


source } s : specifies the fila to raceive the decks, 


Omission causes a fila named for the first specified deck to be 
written in the working catalog. 


selection cr iter la ? seo 3 specifies the file containing Sscu 
selection criteria commands that alone or In conJunction with 
the decks parameter select the decks to be written. 


Omission causes $SNULL te be usade 


include _latest changes { ilc + specifies whether code recently 
transmitted to integration by oather develorers should be 
Included in the decks to be writtene 


Omission causes FALSE to be used. 
exoand + @ 3: specifies wnather the decks are to be expanded. 
Omission causes FALSE to be used. 


expansion dapth {| ed 3! specifies the number of levels of COPY and 
COPYC directives to process. 


Omission causes Swax_ integer to be used. 


aiternatea_product {i ap : specifies other product catalogs in which 
to find source _!}Iibraries to be used as alternate_bases In the 
expansion of the coidae This parametar accepts elthe single 
names or pairs of jnpnames as valuese [If an antry is a single 
values It specifies an alternate product names If a oair of 
values Is spsacifiads the second element specifies the bulld 
Jjevel for the alternate product. If the second value is NONE 
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or only a single vaiue Is spacifieds a build tevel of NONE Is 
assumed. 


Omission causés no alternate _products to be accessade 


alternate _base {| ab 3: spacifies other files that may be required to 
properly expand the desired decks. 


Omission causes NONE to be usede 
product name } pn: specifies the system or oreduct to he used. 


hulld vjlevel {| bi t spacifies the system or product bulld leval to be 
use@de . 


feature catalog i fe 3 sgpecifles the feature catalog to be used (if 
any)e 


feature _build_level ! fbl : spacifies the feature build level to he 
US@G6 


working catalog $} wo : specifies the working catalog to be used. 


working bulid llevel 3} whi : specifles the working bulld leval te be 
usede 


status =? see NOS/VE error handling. 


7207 REPLACELSOURCE (REPS) 


This command can be usad Inside the Working _Environment. 


This command ts used to update a deck on the working source 
itbrarye Tha naw version of a deck on a file is compared with the 
old version on the working library using Scuts 
generate_editicommands facliity. The SCU editor Is then Invoked to 
apoly the resulting adit commands. 


This commands in conjunction with the getlsource commands 
provides the mechanism for making changes to a deck that are 
difficult to make by direct use of the SCU editor. The hest example 
of this Is automated formatting of source code. 


Thea naw version of the working source tibrary Is written as the 
next cycle of the file. 
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CANTION: If you used GETLSOURCE to obtain the source flies vou 
should havea specified FEATURE=ALL and RUILD_LLEVEL=NONE, 
Otherwises some modifications may be missing. 


reniace source sourca=<file> 
deck=s=<€namea> 
modification=<name> 
Cworking_catalog=<catalog>] 
Cstatus*<status variable>] 


source $ s 3 specifies the file which contains the new versian of 
the deck, 

deck 3} d 3 speciflas tha deck to be updated, 

modification 3} m 3: specifies the modification under which the update 
Is to bea made. The anodifilcation must exist In state G6 on the 
working source library. 

working catalog { wo : specifies the working catalog to be used. 


status 3 see NOS/VE error handling. 


Fe2e3 FORMATLICYBILISOURCE (FORTS) 


This command can ba used inside the Working Environment. 

This command formats a CYBIL sourca deck, 

It caltis GET SOURCE to ratrieve the decks, CYBFORM to do the 
formattings and REPLACE _ SOURCE to Incorporate the changes made by 
CYRFEORM., 

If CYBFORM detects an error the replacement is suppressed. 
format icyblil_source deck=<name> 

modification=<nama> 


Cworking catalog=<catalog>]) 
(statuss<status variabied>] 


deck } d 3: specifles the deck to be formatted, 
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modification i mt specifies the modification under which the update 
is to he madee Tne modification must exist In state 0 on the 
working source library. 


working_catalog 1 wo ! spacifies the working catalog to be used. 


status : sage NOS/VE arror handling. 


70209 COMPILELSOURCE (COMMS) 


This command can be used Inside the Vorking Environment. 
This command compilas/assembles one or more decks. 


The defaults hava bean chosen for convenience of developers who 
will typically be daaling with a small number of modules at a time. 


The SCU IJdbraries Included In the list te be searched willl be 
done so in the following order: 
- Working library Cif a working catalog Is In effect) 
~- Feature library (if a feature catalog is in effect) 
Alternate basas (if alternate _bases are specified) 
Latest changes (if include latest changes Is specified) 
0S or product source library 
Product Jibraries (if alternate products are specified) 


At least one of the deck and selection criteria parameters must 
be provided. If both are given the deck parameter Is orocessed 
firste Currentiys if Just tha selection criteria parameter Is 
givens the processor and objJect library must also be supplied. 


Necks to be compiled are specified onty be the DECK parameter and 
by the INCLUPELPECK and INCLUDELGROUP directives of the user 
seciection criteria file (specified by the SELECTION_CRITERIA 
parameter). Modifications to ha applied against the selected decks 
are selected by the BUILDLLEVEL and FEATURE parameters an by 
directives in the user selaction criteria file. The 
INCLUDELLATEST_LCHANGES parameter Indicates whether or not the 
LATEST_LCHANGES fila i=in the product catalog Js to be Inctuded as an 
aiternate basa. 


The salection of dacks and modifications is passed on te the S$cu 
EXPAND DECK command (by this PROC) hy parameter values on the 
command call and by tha selection criteria file which this proc 
always huitds -~ whether or not the SELECTION _CRITERIA parameter Is 
seecified on the proc call. As a result of the call to SCU by this 
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PROC » 


Le 


Ze 


4° 


7s 


the following operations are performed: 


Thea various source libraries specified area merged, That Is» 
certain directories such as tha dack directories and the 
modification direccorles from the various tibraries are 
meraged, A deck which appears on more than one tibrary ts 
selected from the first tibrary on which It Is tocated. 
Howevers modification headers which may appear on more than 
one idibrary are selected fr from the fast library 
encountered. 


Ali modifications resulting from the merge are flagged as 
*“included™; all dacksy, “excluded”, 


Al! modifications In state 6 or 1 are axcluded. This step is 
performed because there may be mods In these states which may 
be of neo Interest to the caltier (they may even be "bad"), 
This does mean that the current mods you are generating and 
testing will be excluded since they are in state 03 howevers 
your mods willl be added later elther by the feature or 
selection criterla parameter. 


The directories ara “rolited hack™ to the specified build ftevel 
- that Iss all new sods Included In bul!lds after the spacifiad 
bulld are exciuded. The directories should now ba in the same 
configuration they were in when the build of the specified 
level was generated. This step is skipoad If the value of the 
PUILDLLEVEL parameter Is NONE. 


Modifications associated with the features specified by the 
FEATURE parameter are now “Included, If the FEATURE 
parameter is not specifieds, the features selected will be 
those in the WEFSFEATURE LIST fille of the working catalog. If 
this file does nat exist or ts emoty and no value Is specified 
for tha FEATURE paramaters then no additional modifications 
wilt be [ncludsad by this step. If the FEATURE parameter its 
given the keyword value of AlLs then step 3 Is essentially 
undone = that is» ail modifications with state 0 or 1 are 
Included. If tha FEATURE parameter Is given the keyword vaiue 
of NONE this step will result In no changes —- that iss no 
modification introduced after the spactifled bulld tftevel willl 
be included. 


Decks specified by the DECK parameter are now Included. Note 
that these ara the only decks which have hee selected for 
compllatlion. 


Tha SCcuU selection eriterisa file soecified by the 
SELECTION_LCRITERTA parameter is now processed. The directives 
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in this file may - intentially or inadvertantly = undo some of 
what has been dune oefore. 


8. Untess both tha PROCESSOR and OBJECTLLIBRARY parameters are 
specified on the call to COMPILE_SOURCEs the PROC will Inctude 
some directives hara to determine those vaiues fer the deck(s) 
under consideration. 


Specifying both the PROCESSOR and OAJECTLLIBRARY parameters 
eauses al! decks to be expanded and then compited together. This ts 
quicker than having the procedure determine orocesser and object 
tibrary for each dack if there are a lot of them. 


When the procadure is run a sub_catalog called 
compilation catalog is created In the working catalog. As the 
modules are processed the objectitext (lao fille) Is written to a 
File In this catalog. Tha flla name Is the same as the destination 
objJect_library which will be written to the maeintenance 
sub_cataloge. Upon successful generation of the object llibrarys the 
object _text file is deleted. If there are no other files In the 
compilation catalog sub _catalogs it is deleted also. 


complle source EC(deckslist of <namad] 
CLselection critter la=<file>] 
Cinciude_latest changes =<boo] aan] 
Cfeaturezlist of <name>] 
Leomplle=<file>] 
Cerocessor= <string>] 
Cobject_library=list of <name>] 
Ciiste<fite>d) 
Ciistloptionszlist of <iist option>] 
{save _listings=list of “save option>d) 
Lalternate productelist of list of<namre>] 
Calternate_base=!list of <file>) 
{product namez<name>] 
feature _cataloys<catalog>] 
[feature bull d _level=<name>] 
[working catalog=<catalog>] 
Cworking bulild_lavel=<namad] 
Cstatuss<status variable>] 


deck } dacks 3} d 3 specifies the decks to be compiled, 
selectionwicriter la $ sce 2 specifles the file cantaining SCU 


selaction criteria sommands that alona or In conjunction with 
the decks parameter select the decks to be comolled. 
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Omisston causes SNULL to be used. 


NOTE: The salection criteria fille cannot be an Interactive 
file. It must not contain an “END” directive. 


Inctude_latest changes i ile 3% specifles whether code recently 
transmitted to Integration by other develorers should be 
included In the dacks to ba compiled. 


Omission causes FALSE to be used. 


Feature ¢$ f & spacifies what features are to be Included when 
compelling spec] fiad decks. The keywords ALL and NONE are atsa 
allowable valuase 


Omission causes flle WEFSFEATURE_LLIST In the user's working 
catalog to be used if It eaxistse. This file Is maintained by 
the ASSIGN MODIFICATION and MAKE L-MONGIFICATION procedures. 


compile | c $: specifies the name of the comoiie fite to be 
generated. It is not disturbed when the procedure completes. 


Qmission causes a uniaue nama te be used and the file to be 
detached when the procedure completes. 


processor { p ! specifies the compller or assembler to be used to 
process each dack, Processor options may ba satected by aliving 
this parameter as a string (@eqe "CYRIL OP=HIGH!'),. 


Omission causes e@ach deck to be processed according to its 
"orocessor™ attributee Obviously the procedure wil! be more 
efficient if a processor Is spacifieds as It wll! not have to 
erocess each deck individually. 


oh fact library { obJjectlliibraries { of :& specifles the objJject 
libraries in the working catalog Into which the 
complied/assemblad aodulas wlll be placed. If an object 
Yibrary already axists the newly compiled modules are combined 
with it to form a new version of the library which effectively 
overwrites the original. if NONE Is specified» no 
object library or object fila will be written. 


Omission causes tha object ltibraries to be selected according 
to each deck's "destination group" attributes. 


fist ¢ | 3 spacifies tha file to which the compilation or assembly 
listings are to be written. . 
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Omission causas SLIST to be used. (Warning =~ in aeohateh job 
$LIST Is connected to OJUTPUT. If a listing ts not desired tn a 
batch job, $NULL should ba specified for list.) 


listloption 3} listlooetions 1} lo ? specifies the listing options to 
he used on each call to a comoller/assembler,. Sea the 
documentation ?or aach “processor™ for valid optionse 


Omission causes (3aR) to be useds i.e. a2 listing of the source 
and across referanca {excluding unreferenced identifiers). 
save_listings $ si : specifies whether Jistings generated by 
processors are to be saved on an SCU Jtibrary called 
LISTING_LIBRARY In the working catalog. Options are ALL» GOOD», 
BAD», and NONE. GOOD and BAD refer to the presence or absence 

of compilation errorse 


Omission causes NONE to be used. 


alternate _product { alternateloroducts { apn : specifies other 
product catalogs in which to find source_tibrartes to be used 
as alternate bases in the expansion of the codé@e This 
Parameter accepts either single names oor pairs of names as 
values. If an entry is a single values [it specifies an 
alternate product name. If a pair of values is soacifieds the 
socond element specifles the bullid tfevel for the aiternate 
product. If tha second value is NONE or only a sinale value 
specifieds a bulid level of NONEs which means all active tines 
at state 2 or highers is assumed. 


Omission causes no alternate products to be accessed. 


alternate_base { alternate bases { ab 3 specifies other files that 
may be required to properly expand the desired deckse 


Nwission causes NONE to be usede 
product name { pn 3: specifies the systam or product to be used. 


bulfdlievel i bis: soecifies the system or product bulld level to be 
usSe@de 


feature catalog { fe : spacifies the feature catalog to be used Cif 
any). 


feature_bulldv-level | *bl : specifies the feature bulld level to ba 
uséd. 


working catalog { we 3: specifles the working catalog to be usede 
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working_bulld_lavel 3} wohl t spacifies the working bulld level to be 
us@ds 


status 3 see NOS/VE error handing. 


7e2%elt) TRANSMITLTOLFEATURE_ CATALOG (TRATFC) 


This command can NOT ba used Inside the Working Environment. 


This command transmits code (decks, modifications, features) from 
aworking catatog to a feature cataloa. 


Onee the transmitted coda has been written to Its destinations it 
Is removed from Its source to free the Interlock on the deck. The 
new version of an affacted source Iibrary is written as the next 
evele of the corresponding fille. NOTE : The transmitted source Is 
stitt avallables however interlockeds in the psprevioustv<highest 
cycle of the working catalog. 


At least one of the dask,s», modifications or feature parameters 
must he provided. {f more than one of them is givan they are 
processed in the order just listed. 


lintike when directiy using SCUs @e9% in a selection criteria 
Flies selecting a modiflcation or feature via this commands 
parameters will result in selection of all decks affected by that 
modification or feature. 


transmit _to_feature_cataliog Edeckszlist of <nema>d] 
C[modification=zlist of <name>] 
Cfeaturesiist of <name>] 
[feature catalog=<catalog>] 
Cworking_catalog=<catalog>] 
Cstatuss<status variabla>] 


deck }{ dacks ! d 3: spacifies the decks to be transmitted, 


modification i wmedifications { m 3: specifles the nodifications to be 
transmitted. 


feature ! features 1 f : spacifties the features to he transmitted. 


feature _catalog i fs % spacifies the feature catalog to be usade 
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working_catalog ! we : spacifies the working catalog to be used. 


status ? see NOS/VE error handling. 


7o2ell TRANSMITLTOLINTEGRATION (TRATI) 


This command can NOT ba used Inside the Working Environment. 


This command transmits code (deckss modificationss features) from 
a featura or (if no feature catalog is being used) working catalog. 


Nnee the transmitted code has been written to Its destinations it 
is reamoved from Its source to free the Interlock on the dack. The 
naw verston of an affactad source Jibrary is written as tha next 
cycle of the corresponding file. NOTE * The transmitted source is 
still avallables however interlockeds, In the previoustv-highest 
cycle of the feature for working) cataloge 


At teast one of tha decks modifications or feature parameters 
must be provided. If more than one of them is aiven they ara 
processed In the order just fisted. 


Unlike when directly using SCUs @e9. %$iIn a selection criteria 
files selecting a aodificatioan or feature via this commands 
perameters wil! rasult in selection of all decks affected by that 
modification or featur a. 


transmit _to_integration [Tdeckse=tist of <name>] 
Cmodificatlion=list of <name>] 
[featurez]ist of <name>] 
[eroduct uname=<nane>] 
{feature _catalog=<catalog>] 
[working catalog=<catalog>] 
Cstatuss<status variable>) 


deck { decks i! d 3: spacifies the decks to be transmitted, 


modification ! modifications ! mt specifies the modifications to be 
transmittad. 


faature ? features } f : spacifies the features to be transmitted. 


product name ! pn : spacifias the system or product to be used. 
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featura_catalog i fe ! spacifies the feature catalog to be used Cif 
any). 


working catalog {% we : specifles the working catalog to he used. 
This parameter is ignored if a feature catalog is used. 


status = see NOS/VE error handling. 
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PROC asslan_moditicationss assian modifications assm { 
features f 3 NAME 
counts c t INTEGER = 1 
modification _descriptlons md 3: string = "NO DESCRIPTION! 
outputs o : File = 3SLOCAL.30UTPUT 
authors, a? string = Sjobluser) 
working catalogs, wo : file 
status) 


PROC compile sources, cons { 

deckss decks di: list of name or KEY ALL 
selection_criterias sco 3 file=z$null 

include latest changes» Ile : hoclean = false 

features f 3: jist of name or key ALLy NONE 
compiles c 3 file 

processors p : string 

object_library,s, o] : iist of name 

Jists i 3: file = $list 

fistloptionss list rloptions lo : fist of key AF OR RA oe 

S X NONE DSFaULT = (S 8) 
save_ltistingss si 3 list of key ALL» NONE», GOOD, BAD = NONE 
alternate_oroductss alternate_products ap ! oe» 
fist of list of name 
alternate_bases, altarnate_base, ah 3: tist of File or ee 
KEY NONE = NONE 

product names pn : name = OS 

buildllevels bi: nawa 

faature_catalogs, foe 3: file or KEY NONE = NONE 
featura_bulidvlievels, *b1l : name = OBJECT 

working catalog, wo: file or KEY NONE # NONE 

working bulidvlaval, wbi 3 name = ORJECT 

status) 


PROC create_sources cres { 
dacks, deck, d: list of name 
modifications m : name = Srequired 
source groups sg ?: nama = Srequiraed 
destinatlion_groups dg t ist of name or KEY NONE = Srequired 
groups, g 3 fist of nama 
processors, p ?: string = fcybil! 
authors a: string = &JjoblCuser) 
deck descriptions, dd : string = $REQUTRED 
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expands @ : boolean 
same_as,» sa : name 
outputs o ? file = $list 
product names pn 3 nama = O§ 
working catalogs we 3: 
feature _catalogs fo 3 
status) 


PROC 

display_ootions, 

key ali = all 

outputs o : Fila = $OUTPUT 
status) 


PROC edit sources, adis ({ 
modifications mods m ? 
decks d t NAME 
outputs, o 3 FILE = $OUTPUT 
working catalogs we %: FILE or KEY 
status) 


NAME 14229 


PROC enter _working_environments entwe 
authors a: string = Sjobluser) 
product names on : name * OS 
bulldvlevels bio: nama 


feature catalogs fo : file or KEY 
feature build lavals, Pbi * name = 
working. catalogs wet file or KEY 
working bulldvlavals, abi 3 name = 
status) 

PRNC eaxitlworking_ environments exiwe( 


status) 


PRQC extract sources exts [{ 
decksy,y decks, d 3 
selection icriterias sco 
ists» 1 3: File = SLIST 
product name, on 2 name = NS 
featura_catalogs, fc st file or KEY 
working catalogs wo : file or KEY 
status) 


PROC format icybl l_sources, forcs ( 
decks d 3: name = Sraquired 
modifications a % nane 
working catalogs», wo 3 
status) 


file or KEY NONE = NONE 
file or KEY NONE = NONE 


display working _enavironments diswe { 
displaycloptions do : 


fist of name or 


NONE # NONE 


NONE = NONE 
OR JECT 
NONE = NONE 
OBJECT 


fist of name or KEY ALL 
s fi§ie = SNULL 


NONE = NONE 
NONE = NONE 


= Srequired 
file or KEY NONE = NONE 
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PROC get sources, gats [ 
dacksy decks, di: list of name or KEY ALL 
sources s ? file 
séelaction_critertas se 3: file<$null 
Include latest codes, ile : boolean = false 
expands e@ : boolean = false 
product names pn ? name = OS 
bulld level, bi : name 
feature_catalogs fo 2 file or KEY NONE = NONE 
feature build levels fbi: name = NBJECT 
working catalog, wo 3s file or KEY NONE = NONE 
working _bulld levels whl : name = OBJECT 
status) 


PROC Yistlinterlocks,s, fisi { 
Yistlfile 3: file = S0UTPUT 
status) 


PROC make_modificetions maka { 
modifications m 2 NAME 1.29 = SREQUIRED 
features f 3 name 
modification descriptions md : list of string = SREQUIRED 
authors a 3% string = $Jjobluser) 
working catalogs we ? file = $user 
status) 


PROC replace _sources raps ( 
sources 5s : flila = SREQUIREN 
decky d t: MAME = $REQUIRED 
modifications, mods mt NAME 1.429 = SREQUIRED 
working catalogs we : FILE or KEY NONE = NONE 
status) 


PROC set lworking_environments, setwe ( 

authors a? string = Sjobluser) 

product names apn 3 name = OS 

bhulldllevels bi 3 name 

tool_library_bulld llavel, tibi % name 

faature catalogs, fo 3: file or KEY NONE # NONE 
feature_bulJdllevels, fbhi t name = OBJECT 
working catalogs wo i: file or KEY NONE = NONE 
working bul! d ulevals whi : name = DAJECT 
status) 


PPC transmit_to_featura_cataloas, tratfec ( 
deckss decks di: List of name or key ALL 
modificationss nodifications m 3: Jist of name or key ALL 
featuress featuras f 3 Fist of name or key ALL 
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